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consult Appendix |, and disk users should consult Appendix 2 
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FEATURES 


Windows - icons - pull-down menus - pointing devices 
All information on screen 

Works with keyboard, joystick, mouse or koala pad. 

Dot matrix printer dumps - 5 sizes + grey-scale 

Supports Commodore bus and Epson compatible printers 
Save and load pictures to cassette/disk 

Full control over attributes 

16 pens, 8 random sprays, 16 user-definable brushes 
‘Undo’ facility 

Windows can be cleared, inverted, cut & pasted, enlarged, re- 
duced, squashed, stretched, flipped, and rotated 

Solid fill 

Textured fill - 32 user-definable patterns include stipples, 
hatches, bricks, roof tiles etc. 

Wash texture facility 

3 levels of magnification with pixel edit, pan and zoom 
Text-9 character sizes, 2 directions, bold, rotate font 
Font editor - clear, invert, flip, rotate characters or whole font, 
copy ROM, capture font from window 

Save and load fonts to cassette/disk 

Lines, rectangles, triangles, circles and rays 

Snap + elastic shapes 
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HOW_TO USE THIS MANUAL 


This manual is designed to cover both the cassette and disk versions 
of the OXFORD COMPUTING ART STUDIO. 


To use this package, Commodore 128 users should enter 64 mode 
by holding down the Commodore key when turning the machine on, 
or by typing GO 64. 


Before you can use the program, you must configure the program 
for your particular printer, and in the case of the cassette version, 
you must save a personalised copy to a blank tape. Cassette users 
should consult Appendix | to learn how to do this, while disk users 
should consult Appendix 2. Then read the Introduction immediately 
below, which explains the basics of the program and how to control 
it. This will prepare you enough to enable you to load your person- 
alised copy and begin using ART STUDIO. 


Explore the program at your own pace, aiming to get a ‘feel’ for its 
structure and workings. Don't be afraid to experiment. Read the rest 
of the manual to clear up specific points and for reference. 


You are not expected to read the manual all the way through before 
using the program for the first time. 


INTRODUCTION 


ART STUDIO ts built upon the ‘windows - icons - mouse -pointing 
device' concepts as pioneered by Xerox at Palo Alto and popularised 
by Apple with the Lisa and Macintosh computers. The guiding 
philosophy behind these developments is that a program should be 
easy for the first-time user to operate, with all relevant information 
‘on screen’, and no complicated keyboard sequences to learn. [n- 
stead, commands are given by simply ‘pointing’ at options in screen 
menus. 
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When you first run ART STUDIO, you will be presented with a 
clear screen with a blue and white 'menu bar' at the top and a small 
black arrow in the centre. The arrow (known as the 'cursor’) is the 
key to the program. It is controlled either by the keyboard, a joy- 
stick, koala pad, or a mouse. For example, when controlled by the 
cursor keys, pressing the '*' key moves it to the left, and pressing the 
'£' key moves it up. The motion of the cursor is ‘intelligent’, in the 
sense that is speeds up the longer a key is held down. 


The menu bar at the top of the screen contains a number of individ- 
ual boxes with headings in them. Moving the cursor to within one 
of these boxes and pressing the ‘select’ button (the ‘fire’ button if 
using a joystick, or a designated key if using the keyboard), causes 
a subsiduary menu to be drawn on the screen partly overlaying the 
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main menu bar. This process is known as 'pulling down’ a menu. 
The subsiduary menu contains a number of entries or ‘options’, 
which may lead to further sub-menus, or cause certain actions or 
commands to be performed. An option is chosen by moving the 
cursor to it (it will ‘highlight’ if it's available) and pressing the select 
button. This process is known as ‘clicking’ an option. If the option 1s 
a command then what usually happens is that the pull-down menu 
disappears and the arrow cursor changes into a small icon which 
bears some relation to the command selected. For example, a paint 
brush when painting on the screen. The icon here is acting as a 
reminder of the current 'mode'. This new cursor can then be moved 
about the screen using the same controls as the arrow cursor. The 
action of the ‘select’ button depends on the particular icon. For 
example, with the brush icon, pressing ‘select’ paints pixels on the 
screen. 


If the icon cursor is moved into the menu bar at the top of the screen, 
it immediately reverts to its arrow form. However if it is moved 
back out again, then it returns to its icon form, unless another menu 
has been pulled down in the meantime. The program will continue 
to stay in the current mode (with the current icon) until another 
mode is selected. Note that for most commands, the screen can be 
scrolled by clicking the arrow boxes in the menu bar (see below) 
without losing the current mode. 


As mentioned above, if an option in a pull-down menu is highlight- 
ed as the cursor is moved over it, then that option is available. 
Options in some menus will only be highlighted if certain condi- 
tions have been met. For example, consider the Windows menu. An 
action can only be performed on a window, say cleared, if the 
window has previously been defined. Consequently, when the Win- 
dows menu is pulled down for the first time, the 'Define window’ 
option is highlighted, but the ‘Clear window’ option is not. After 
defining the window, and pulling down the Windows menu for the 
second time, the above condition is met, and so the 'Clear window' 
option becomes highlighted as the cursor is moved over It. 


Some menus contain options which are neither commands nor lead 
to sub-menus. These are known as flags or 'switches' - devices 
which can be in one of two states, on or off. These switches 


generally modify the behaviour of other options in the same menu. 
For example, there is a switch in the Text menu which controls 
whether characters are printed sideways or not. The on state is 
represented by a tick, and the off state is represented by a cross. A 
switch can be changed state (‘toggled') by moving the cursor to it 
and pressing select. 


Often there is a choice in a menu between two or three ways of 
doing something. For example, there are three sizes in which char- 
acters can be printed, either 'Normal height’, 'Double height’, or 
'Treble height’. These are shown as three separate options in the 
Text menu, only one of which is marked with a tick, the others being 
unmarked. The tick indicates which height currently applies. The 
height can be hanged by moving the cursor to one of the unmarked 
options and pressing select. 


The full CBM 64 screen is 25 ‘lines’, but the menu bar permanently 
occupies 3 of these lines. You may think then that you are limited 
to designing pictures that fit in the remaining 22 lines. However, this 
is not the case. The two boxes in the menu bar with arrows in them 
allow you to 'scroll' the visible part of the screen over the full 25 
lines. Clicking one of the arrow boxes scrolls the screen by one line, 
clicking it three times scrolls it by the full amount. The box imme- 
diately to the right of the arrows contains a rectangle representing 
the complete picture, with a highlighted bar showing the portion 
currently on display. 


Print}File jAttrs [Paint [Misc [Undo | 


Ga ] 
Fiit [Magni fy|Text [Shapes |e 


To remove or collapse a menu pulled down by mistake, just move 
the cursor outside of it and press select. 


The bulk of this manual is divided into sections, each section 
covering one of the options in the main bar. The sections logically 
follow the same order as this menu, reading from left to right, then 
top to bottom. 


CONNECTING INPUT DEVICES 


ART STUDIO will accept input commands to move the cursor and 
select options from four different sources: the keyboard, a joystick, 
a mouse or a Koalapad; however it can only support one of these at 
any one time. (e1ther joystick port may be used for the joystick, 
mouse or Koalapad if these are used). At all times, ART STUDIO 
displays an icon representing the device it is expecting to receive its 
commands from in the right hand box of the top menu bar. The 
device may be changed by holding down the Commodore Key (at 
the bottom left corner of the keyboard) and pressing the space bar - 
this operation is repeated until the icon display matches the required 
device. It is quite possible to have two different input devices 
plugged into the two input ports at the same time, and select be- 
tween them using the procedure above; however, the program will 
only work properly with the device whose icon 1s displayed. 


At certain times, ART STUDIO will change the icon without in- 
struction when it expects input from a different source to the select- 
ed device, for instance when entering text such as filenames. When 
this happens, the new device should be used; the icon will change 
back once the operation is complete. 


When using the Keyboard to move the cursor, the following keys 
control its direction: 


£- UP * - LEFT “- RIGHT =- DOWN 


The space bar is used to select options and issue commands such as 
paint, fill, etc. 


DEFINITION OF TERMS 


A 'pixel' is a single dot on the screen - the smallest picture element. 
The screen is divided into blocks of 8 by 8 pixels - a block being 
known as an ‘attributes square’. A pixel can either by ‘set’ (on) or 
'reset’ (off). A set pixel shows the ‘ink' colour for the associated 
attributes square, and a reset pixel shows the 'paper' colour. Only 
two colours are allowed per attributes square (per 64 pixels). This 
limitation must be born continuously in mind when drawing pic- 
tures on the CBM 64 screen. 


PRINT 


Print Fils ATT rs Paint Misc [Unda | ? 


nr ee ec 


ry 
A 

on 
i] 


Hi, Cl 
My N) it 


This menu allows you to take a hard copy of your finished picture 
on a dot matrix printer capable of bit image graphics. Five sizes of 
printout are available, labelled in the menu 'I x 1 dump' to '5 x 5 
dump’. These figures correspond to the number of dots on paper to 
one dot or pixel on the screen. Not all of these sizes of dumps will 
necessarily be available with the particular printer you are using, it 
depends on the total number of dots the printer is capable of resolv- 
ing across a page. If a dump option is available, then it will be 
highlighted as the cursor is moved over it. 


Note that none of the colour information in a picture is recorded in 
its hard copy by these first five options, but purely whether individ- 
ual pixels are set or reset. It is important to bear in mind that this 
could lead to some discrepancies between what is seen on the screen 
and what is seen on paper. For example, a section of a picture could 
have attributes of white Ink on white Paper, then any pixels that 
were set within that section would not show up on the screen, but 
would be quite visible on the printout. 


While the dump is in progress, the entire picture is displayed on the 
screen. The dump may be aborted at any time by pressing the 
RUN/STOP key. Note that your printer may need resetting. A 
'grey-scale dump’ is also available, which uses 'stipples' -arrange- 
ments of dots of varying density - to represent the different colours 
found on the CBM 64. The grey-scale dump is equivalent in size to 
a3 x3 dump. 


Most dot matrix printers capable of bit image graphics can operate 
in two different modes known as single density and double density. 
The resolution in the latter mode is generally greater than that in the 
former, i.e. more dots can be printed across the page. You can 
switch between these two modes via the Print menu. Some of the 
dumps not available in single density mode may become available 
in double density mode as a consequence of the increased resolu- 
tion. Note that there may be some distortion in double density mode 
with the picture appearing to be stretched out down the page. 


It is possible to print a picture sideways, from left to right, rather 
than from top to bottom. Because the CBM 64 screen has a greater 
width than height, 1t may be possible to select one of the larger 
dumps in sideways mode that would not otherwise be available. 


The three options ‘Left justify’, ‘Centre’ and ‘Right justify’ determine 
whereabouts across the page a dump is situated, either hard against 
the left-hand edge, in the centre with equally spaced margins, or 
hard against the right-hand edge. The tick indicates which option 
applies. 


FILE 
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The Commodore ART STUDIO provides full support for the stor- 
age and retrieval of pictures (known as 'files') on both disk and 
cassette tape. All files have a filename associated with them; picture 
files used by ART STUDIO have names which are 16 characters 
long, of which the first eleven are supplied by you to identify your 
pictures. The remainder are reserved by ART STUDIO to tell them 
apart from the other types of file on your disk or cassette tape. 


To use the Commodore tape drive, pull down the file menu and 
select 'Cassette' to obtain the tape menu. To save the current screen, 
first ensure that your tape drive contains a blank tape, then select the 
'Save Screen’ option. A prompt then appears asking you to specify 
the filename, and the device icon changes to the picture of the 
keyboard. Enter up to 11 characters and press RETURN on the 
keyboard; unless you have already done so, a message will appear 
asking you to press RECORD and PLAY on the tape drive. 


Once this is done, the screen will be saved onto the cassette and the 
display will eventually return to the main menu. The RUN/STOP 
key may be pressed at any time throughout the operation to abort it 
and return to the current menu; if the tape has already started this 
will produce an error message on the screen. 


After saving the screen, the 'Verify Screen' option may be used to 
check the tape. This option compares the current screen to the next 
file on the tape and reports an error if there 1s any difference. 


The 'Load Screen’ option replaces the current contents of the screen 
with the picture contained in the specified cassette file, while the 
'Merge Screen' option merges the current screen contents with the 
file on the tape. In the latter case, the screen colours are not changed, 
and the pixels in the two pictures are combined according to the 
state of the Overwrite switch. If the switch is off, the pixels are 
ORed together to produce the final picture, while switching Over- 
write on causes an Exclusive OR to be used instead. Note that the 
screen 'back-up' store is used during loading and merging, and 
hence 'undo' is not available after these operations. 
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ART STUDIO also supports up to four Commodore disk drives, and 
has the ability to read a list of the files held on the currently selected 
disk and hold this list in tts memory. The disk menu is displayed 
when the 'Disk' option is selected from the file menu. When the 
program is started, 1t assumes that you are using device number 8, 
and when the disk menu is displayed for the first time it will read the 
catalogue from this device. The large box on the right of the menu 
will then fill up with a list of ART STUDIO files on the current disk, 
and the box at the top right corner shows the name of the disk and 


the amount of free space still available. Once a filename has been 
displayed in the list on screen, it may be 'selected' by pointing to it 
with the cursor and pressing 'select', and an operation performed on 
it by pointing to the operation and selecting again. This provides a 
much easier method of handling files than the normal method of 
entering long commands and filenames on the keyboard. 


The capacity of the catalogue held in memory 1s about 48 entries, 
however only 9 can be displayed on the screen at once. The arrow 
boxes enable you to scroll through the whole catalogue, and the bar 
between the two arrows shows which section of the catalogue 1s 
being displayed. The box with the linked squares (the ‘home’ sym- 
bol) allows you to move directly to the start of the catalogue. 


To change the currently selected drive, point the cursor at the 
‘Device’: option and hold ‘select’ down until the required device 
number is displayed. On releasing select, the catalogue of the new 
drive is displayed, replacing the previous one. The catalogue of 
current drive is also read after operations which cause it to change 
are performed, and whenever the ‘Reset’ option on the menu is 
selected; this allows a new catalogue to be read when the disk in the 
current drive is swapped for another containing different files. (Note 
that once ART STUDIO has been loaded from disk, there is no 
reason for the program disk to remain in the drive.) 


Pictures on the disk may be loaded or merged by selecting their 
filename from the catalogue and selecting ‘Load’ or ‘Merge’; these 
options will have no effect if no filename is highlighted. Saving the 
screen to disk is accomplished by selecting ‘Save’; a prompt then 
appears for you to enter a filename. If a filename is currently 
highlighted it will be displayed after the prompt, and by pressing 
RETURN the contents of that file will be replaced by the current 
screen. 


The delete key could be used instead to delete some or all of the 
name and replace it with anew one. As with cassette operations, the 
RUN/STOP key may be used to abort the current operation and 
return to the menu. 


Some additional disk operations are also provided for the manipula- 
tion of files and disk volumes from within ART STUDIO. A new 
disk may be formatted, ic prepared for use by the disk drive, by 
selecting 'Format’. A prompt then appears requesting a label for the 
new volume; enter this via the keyboard and press RETURN. The 
operation takes about a minute, after which time the cursor reap- 
pears and a (blank) catalogue of the new disk is displayed. 


After a disk has been used for a long period of time, it may become 
‘fragmented’, which means that the files 1t contains are spread out in 
lots of small pieces throughout the disk. By selecting the 'Clean Up' 
operation, the disk is tidied up to make the loading and saving more 
efficient. 


If the contents of a particular file are no longer required, it may be 
deleted from the disk to make room available for new files. This is 
done by selecting the filename from the catalogue and selecting the 
‘Delete’ option. The name of a file may be changed by selecting it 
from the catalogue and using the ‘Rename’ option. A prompt is then 
put on the screen for the new filename, and pressing RETURN will 
issue the command for the name to be changed. 


Finally, all the files on the disk may be deleted at once by selecting 
the 'Clear' option. This provides an easy way of completely clearing 
a disk that is no longer required. ART STUDIO seeks confirmation 
before carrying this out. 


ATTRIBUTES 


Transparent 


Standard ao 


This menu controls the setting ‘of colours in the picture and the way 
in which pixels are set or reset. These attributes apply to all painting 
and drawing that is done on the screen - to shapes, pens, brushes, 
fills, text etc. 


For example, to set the Ink colour to orange, select the 'Set ink’ 
option from the attributes menu. A submenu will appear containing 
16 boxes of colour and the word 'Transparent'. Move the cursor to 
the orange box and press select again - from then on, anything 
drawn on the screen will be in orange ink. Note that the box with an 
outline_drawn around oe indicates the. the current Ink colour. 
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The paper colour is set in the same way, using the 'Set Paper' option. 
Both ink and paper colours may be set to Transparent, which means 
that they are not changed when anything is drawn on the screen. 
This is useful for "touching up" your pictures once they have been 
drawn, and is selected by pointing to the word 'Transparent' in the 
Ink or Paper menus. A transparent ink is indicated by a tick next to 
the option in the ink menu. 


The Border colour can be altered from the Attributes menu by 
selecting the 'Set border’ option. Note that it is not possible to select 
a transparent border. 


The two switches, 'Overwrite' and 'Inverse', determine the way in 
which individual pixels are altered by the various ART STUDIO 
operations. Overwrite, when set, normally means that new and old 
pixels are combined on an exclusive basis instead of the normal OR 
function, while setting 'Inverse' usually means that new pixels are 
reset instead of being set. These options are described further in the 
sections that concern them. 


The option market 'Transparent' sets all inks to transparent and turns 
off the Overwrite and Inverse flags. Finally, the 'Standard'’ option 
sets all of the attributes to their default or initial values, te grey 
Paper, black Ink, grey Border, and Overwrite and Inverse both off. 


This menu controls some of the main facilities for drawing on the 
screen. It provides access to three different 'tools' - a pen, a spray 
can and a brush. 
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Sixteen pens of various shapes and sizes are available. To use a pen, 
move the cursor down the Paint menu until the 'Pen' option is 
highlighted, press select to pull down a menu containing the differ- 
ent pens, choose one by pointing at it with the cursor, then press 
select again. The arrow cursor will be replaced by a representation 
of a pen. This cursor can then be moved about the screen and pixels 
painted with it by pressing select. If the select button is held down 
as the cursor is moved, continuous lines can be painted. 


If the 'Inverse' switch is off (this is the same Inverse as in the 
Attributes menu), the pens will set pixels in the current Ink colour. 
If the 'Inverse' switch is on, however, the pens will reset pixels. The 
latter make very effective erasers. 
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Eight spray cans with a range of diameters are available, each of 
which sprays a random pattern of dots on the screen. You can 
demonstrate this random nature by choosing one of the larger 
sprays, and holding down the select button while keeping the spray 
can in one place. Eventually a solid disc will be drawn. The spray 
may of course be moved as it is painting to produce graffitti-like 
effects. 
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Finally, sixteen brushes of various sizes and designs are available. 


Each brush has associated with it a 'mask', which has the, same 
dimensions as the brush itself. When a brush is used to paint on the 
screen, first the pixels corresponding to the mask are reset, then the 
pixels corresponding to the brush itself are set (or vice versa if the 
Inverse switch is on). The advantage of having a mask is that it 
allows more complex designs to be painted, but for simple brush 
patterns it can just be ignored. 


The first brush in the 'Select brush’ menu is a null brush. This is a 
very useful brush as it can be moved over a picture changing the 
colour information without setting or resetting any pixels. You may 
find it convenient to design your pictures in black and white, and 
then add colour in the final stages — a brush such as this. 
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Each of the sixteen brushes can be edited to suit particular require- 
ments. To edit a brush, move the cursor to the option marked ‘Edit 
brush' in the Paint menu, and press select to pull down a menu 
containing large scale representations of the brush and its mask and 
a copy of the brush at normal size. Individual pixels in the brush and 
mask can then be toggled (changed state) with the cursor. The newly 
edited brush can be painted with by pointing the cursor at its normal 
size image and pressing select. 


The ‘Edit brush' option acts upon the current or last used brush. To 
edit a particular brush, you must first make it the current brush by 
choosing it from the 'Select brush’ menu, then pulling down the 
Paint menu for a second time and clicking the 'Edit brush' option. 


16 


MISCELLANEOUS 


The first option in this menu removes the menu bar from the top of 
the screen and allows you to view the entire 24 lines of your picture. 
Press the select button to return to the menu. Note that 'undo' (see 
below) does not function after viewing the screen, but remember 
that you can always scroll a picture by clicking the up-arrow and 
down-arrow boxes to see the extra three lines and still retain the 
'undo' facility. 


The second option clears the whole screen and sets its attributes to 
the current colours. 'Undo' is available if you clear the screen by 
mistake. 


The 'Change colour’ option is only highlighted if a window has 
previously been defined (see the section covering the Windows 
menu below). Its function is to change one colour into another over 
the whole, or part of, the screen. Two colours are defined via the 
Attributes menu, a source colour is specified as the Ink colour. The 
option then converts all occurrences of the source colour to the 
destination colour within the defined window. 


The final option in the Miscellaneous menu displays a copyright 
message and the release number of the particular version of ART 
STUDIO you are using. 


UNDO 


This is one of the most useful facilities in ART STUDIO as it 
undoes the effects of the last command or operation. 


When a command such as 'fill' 1s selected, the main screen 1s 
automatically copied to a special back-up store. The fill operation is 
then performed on the main screen. If the result is not what's 
required, then clicking the 'Undo' box causes the back-up store to be 
restored to the main screen. 


It is important to realise that this facility only works immediately 
after any change to the screen. 


WINDOWS 
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A window is a rectangular section of the screen, marked by a dotted 
outline, which can be acted upon as a whole. Windows can be 
cleared, inverted, moved, copied, re-scaled, flipped, and rotated. 
'Undo' can be used after a window has been processed to reverse any 
effects. 


Before any action can be performed on a window, it must first be 
defined. To define a window, pull down the menu from the 'Win- 


dows' box, move the cursor to the 'Define window’ option and press 
select. The arrow cursor will be replaced by a small box cursor. 
Move this cursor about the screen and press the select button twice 
to define two opposite corners of the window. The outline of the 
window will be marked on the screen with a dotted line, and the 
cursor will turn back into an arrow. The Windows menu can then be 
pulled down for a second time and one of the window processing 
commands selected. 


A window that is larger than the 22 visible lines of the screen can be 
defined by clicking the first corner, clicking one of the arrow boxes 
to scroll the screen, then clicking the second corner. The option 
‘Whole screen’ defines the whole screen as a window. The option 
‘Last window’ re-defines the last used window. 


Clicking the option 'Clear window’ resets all the pixels in a window 
and makes its attributes equal to the current Ink and Paper colours. 


A window can be copied after being defined by clicking the 'Cut & 
paste window’ option. A second window outline appears which 
moves as a whole with the cursor, and when the select button is 
pressed, the original window is copied to the new window. At- 
tributes as well as pixels are copied across. Note that the second 
window is moved via the first corer defined in the original window. 


The option 'Cut, clear and paste’ is similar to the above with the 
addition of clearing the original window when copying it, 1.¢. it 
effectively moves a window. 


Multiple copies of a window can be made by setting the ‘Multiple’ 
switch to on before selecting the 'Cut & Paste’ and ‘Cut, clear & 
Paste’ options. 


Normally a window overwrites the screen when pasted. Window 
can, however, be combined or merged with the existing screen by 
setting the ‘Merge’ switch to on. If the Over switch (in the Attributes 
menu) is currently off, pixels are combined on an OR basis. If the 
Over switch is on, pixels are combined on an XOR basis. Attributes 
are not merged, but taken directly from what is already on the screen. 
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Clicking the option 'Invert window' toggles all the pixels in a 
window, but doesn't change its attributes. 


A window can be enlarged, reduced, squashed, or stretched -actions 
collectively known as 're-scaling’. A window is re-scaled by click- 
ing the 'Re-scale window' option, which gives the box cursor again 
and allows a second window to be defined. The original window is 
then 'mapped' onto this second window, being re-scaled as neces- 
sary to fit into the new outline. 


Re-scaling is a two stage process. A window is first re-scaled in the 
vertical direction to an internal buffer, and then re-scaled in the 
horizontal direction to the screen. There will be a short delay 
(depending on the size of the window) while the first stage is 
performed. 


Note that there may be some loss of fine detail when a window its 
reduced in size. Also there may be overlapping and blurring of 
attributes. 


The option 'Clear & re-scale’ clears the original window when 
re-scaling it. ‘Merge’ and 'Multiple’ apply to the re-scaling of win- 
dows in the same way that they apply to the cutting and pasting of 
windows. 


Windows can be ‘flipped’ or mirrored about their horizontal and 
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vertical axes, by clicking the 'Flip horizontal’ and 'Flip vertical’ 
options respectively. Attributes are also flipped. 


Finally, windows can be rotated clockwise by one-quarter, one-half, 
and three-quarters of a complete turn. These are equivalent to 90, 
180 and 270 degrees respectively. Attributes are also rotated. 


FILL 
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Filling is a technique for rapidly setting all the pixels within an 
object or shape on the screen. The object to be filled must have a 
continuous outline, but the outline can be quite complex. An object 
can be filled with solid colour or it can be filled with a pattern. A 
wide range of pre-defined patterns, or textures as they are known, is 
available. These include various stipples and hatches, and special- 
ised patterns such as bricks and roof tiles. In addition, scratch 
patterns can be designed to suit individual requirements. 


To fill an object solidly, move the cursor down the Fill menu until 
the 'Solid fill’ option is highlighted and press select. The arrow 
cursor will be replaced by a representation of a paint roller. Move 
this cursor about the screen to some point within the object you wish 
to fill, then press select again. The fill will proceed outwards in 
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every direction from the chosen point (which must be a reset pixel) 
until a set pixel or the border of the screen is encountered. 
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To fill an object with a pattern, move the cursor down the fill menu 
until the "Textured fill’ option is highlighted, then press select to pull 
down a menu containing the 32 available textures. Click the desired 
texture, then click some point within the object to be filled. A 
textured fill is a two stage process. First an ordinary solid fill is 
done, then the chosen texture is 'mapped' onto all the pixels on the 
screen that have been set by the solid fill. 


All fills are done in the current Ink and Paper colours. Inverse does 
not apply to solid fills, but does apply to textured fills (the textures 
are shown inverted in the menus if the Inverse switch is on). Over 
applies to neither fill. 


Note that fills take place over the whole screen including the three 
lines not visible at any one time. The results of a fill can be checked 
by clicking the up-arrow and down-arrow boxes in the main menu 
bar to see these extra lines. A fill can be aborted by pressing the 
RUN/STOP key. If a fill 'leaks' out of an object, or is in any way 
unsatisfactory, 1t can be removed by clicking the 'Undo' box. 


The texture at the end of the first row is a null texture. This is useful 
for setting the attributes within a section of the screen without the 
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net altering of any pixels. 


You may like to know that the fill algorithm is structured around an 
internal stack which stores line segments for the object being filled. 
Approximately 8 kilobytes of memory are available to this stack, 
but it is possible that very convoluted shapes may cause the stack to 
overflow. If this happens, ART STUDIO will not crash, but it may 
leave some small holes in the object being filled. However, this is 
hardly ever likely to happen in practice. 


'Wash texture’ is a powerful feature that effectively allows you to 
paint directly with a pattern. It uses the same menu of 32 textures as 
the above, and works by 'mapping' a chosen texture onto any pixels 
on the Screen that have been changed (set or reset) by a previous 
operation. This process is essentially an extension of the second 
stage of a textured fill. Note that it only works immediately after 
pixels have been altered. 


For example, you could draw a rectangle using the Shapes menu 
(see below), and then wash one of the stipple textures onto it to get 
a dotted outline. Or you could wash a stripped texture onto a line of 
text for distinctive lettering. 


Print|Fite [attrs [Paint [Misc [Undo 
Mindows, t sonra BLS 


bait texture 


Each of the 32 textures can be edited to suit your particular require- 
ments. To edit a texture, move the cursor down the Fill menu until 
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the 'Edit texture’ option is highlighted, then press select to pull down 
a menu containing a large scale representation of the texture and a 
sample of the texture at normal size (actually four copies of the 
texture so an idea of how it 'fits together’ can be obtained). Again 
the normal size image is shown inverted if the Inverse switch is on, 
but the large scale representation is not. Individual pixels within the 
texture can then be toggled with the cursor. The newly edited 
texture can be used by clicking its normal size image. 


The 'Edit texture’ option acts upon the current or last texture. To edit 
a particular texture, you must first make it the current texture by 
choosing it from one of the 'Select texture' menus, then pulling 
down the Fill menu for a second time and clicking the 'Edit texture’ 
option. Note that the current texture 1s marked with an outline. 


MAGNIFY 
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ART STUDIO allows areas of the screen to be magnified for 
detailed examination and alteration on a pixel by pixel basis. Three 
levels of magnification are available, with facilities to edit pixels 
and pan and zoom in each. Pixels will be set to the current ink colour 
and reset to the current paper colour. 


To magnify a section of the screen, pull down the Magnify menu 
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from the main menu bar, then move the cursor down this menu until 
one of the options 'Mag.x2', 'Mag.x4' or 'Mag.x8' is highlighted, and 
press select. The arrow cursor will change into a representation of a 
magnifying glass. Move this cursor about the screen to the particular 
area you wish to magnify, then press select again. The main screen 
will be replaced by a magnified image of this section of your picture. 
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An individual pixel within the magnified section can be set, reset or 
toggled (set => reset, reset => set) by positioning the cross-hair 
cursor over it and pressing select. The specific pixel operation is 
chosen by clicking one of the 'Set', 'Reset' or "Toggle' boxes in the 
menu bar at the top of the display. The cursor can be moved while 
the select button is held down to alter pixels more rapidly. 
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Pixels will be set and reset in the current Ink and Paper colours. 
Inverse and over do not apply. The Attributes menu is available 
directly from the menu bar at the top of the display - this menu has 
already been discussed. 


The area to be magnified can be scrolled over the whole screen by 
clicking the boxes with arrows in them, or 'homed' by clicking the 
box containing the linked squares symbol. The scrolling auto-re- 
peats if the select button is held down. The white bars between the 
pairs of arrow boxes show which fraction of the whole screen is 
currently being magnified 


The magnification can be changed at any time by clicking one of the 
'x2', 'x4', or 'x8' boxes in the top left-hand corner of the display. The 
current magnification is shown highlighted. 


When editing is complete, a return to the main menu is made by 
moving the cursor to the box marked 'Menu' and pressing select. 
Note that 'Undo' ts not available after magnifying the screen, as the 
back-up store is needed for workspace. 


A grid is available in the x8 magnification mode - one square in the 
grid representing one pixel on the screen. This grid can be switched 
on or off from the initial Magnify menu. 


TEXT | qa 
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This menu controls the addition of text - letters, numbers, punctua- 
tion etc - to a picture. Text can be printed from left to right or from 
top to bottom, and the characters can be printed in one of nine 
different sizes. Printing takes place in the current Ink and Paper 
colours, with regard to the Overwrite and Inverse switches. 


To add text to a picture, select either the ‘Left to nght’ or the 
‘Downwards' option from the Text menu. The arrow will change 
into a cursor which looks like a capital I. Move this cursor about the 
screen to the point at which you wish to add your text and press 
select again. This I cursor will be replaced by an underscore, which 
is the text entry cursor, and the device icon will show a picture of 
the keyboard. Type in your text - if you make a mistake, the last 
character can be deleted using the INST/DEL key. Full cursor 
control is available using the normal Commodore cursor keys, and 
the RETURN key places the cursor at the start of the next line or 
column. 


As each character 1s printed, the cursor is advanced to the next 
character position, either immediately to the nght or immediately 
below, depending on the chosen direction. Text entry may be termi- 
nated and the I cursor recovered using the RUN/STOP key. In 
addition, while entering text, the four function keys may be used as 
follows: 


Fl and F3 scroll the screen up and down (equivalent to pointing the 
cursor at the arrow boxes in the top menu and pressing select). 


F5 is equivalent to selecting Undo in the top menu bar, and will 
Undo all text entered since positioning the I cursor and pressing 
select. 


F7 terminates text entry (equivalent to RUN/STOP). 


Characters may be entered in upper or lower case by using the Shift 
key, and the copyright symbol is available by shifting the asterisk 
key. Symbols are available by shifting the numbered keys and 
various punctuation keys. 


Three character widths are available, together with three different 
heights. These are selected by pointing to the required size in the 
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text menu and pressing select - a tick shows the width and height 
currently selected. The combination of heights and widths allows 
nine possible character sizes, and the current character size is re- 
flected in the sizes of both the I cursor and the underscore to allow 
correct positioning of the text. 


Text may be printed in bold type, where each character is printed 
twice, the second time one pixel to the right, and so appears to stand 
out. Turn the 'Bold' switch on in the text menu to use this feature. 


With the 'Caps-Lock' switch on, the letters (a to z) are always 
printed as capitals - this switch does not affect the punctuation keys 
or the numeric keys. The Shift lock key on the Commodore key- 
board may also be used if required, but this will affect the whole 
keyboard. 


A useful facility in this menu is the ability to 'Snap' characters into 
the attribute cells to avoid disturbing the colours of neighbouring 
cells. Snap is available individually in the horizontal and vertical 
directions by selecting the switches in the menu. As an example, if 
both snap switches were on, and normal height and width had been 
selected, any characters printed on the screen would occupy exactly 
one attribute cell each. 


Finally the last option in the text menu invokes a Font Editor. 
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FONT EDITOR 
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There are 91 characters that can be edited; these represent Commo- 
dore screen display codes 0 to 90. (These are the numbers that you 
can POKE into the screen memory from BASIC to display charac- 
ters @ to Z in text mode.) Fonts can be saved/loaded to and from 
tape and disk. 


The 91 characters in a font are displayed at the bottom of the screen, 
each consisting of 8 by 8 pixels. One of these characters is the 
current character, this is marked by a top and tail cursor. The current 
character and the characters immediately to its left and right are 
shown in enlarged form above the font. The individual pixels in 
these three characters can be toggled with the arrow cursor. 


A particular character can be made the current character by pointing 
at it in the font at the bottom of the screen and pressing select. 
Alternatively the current character can be scrolled through the entire 
font by clicking the boxes with arrows in them. The scrolling 
auto-repeats if the select button is held down. 
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There are a number of operations that can be performed upon the 
current character by pulling down the menu from the 'Character' 
box. These operations are, clear character (reset all pixels), invert 
character (toggle all pixels), flip horizontal, flip vertical, rotate 1/4 
(90 degrees clockwise), scroll right (1 pixel), and scroll down (1 
pixel). A character can be rotated by more than 90 degrees by 
selecting the rotate option two or three times, or scrolled by more 
than one pixel by repeatedly selecting the last two options. 


The same set of operations can be performed upon the font as a 
whole by pulling down the menu from the 'Font' box. The option to 
clear the font seeks confirmation before proceeding as it cannot be 
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The character set contained in the CBM 64 ROM (the characters 
available in BASIC) can be loaded into ART STUDIO's font by 
selecting the 'Copy ROM' option in the 'Misc.' menu. 


The 'Capture font’ option in the Misc. menu is only highlighted if a 
window has previously been defined (see the section covering the 
Windows menu above). Its function is to copy block of pixels from 
the defined window on the screen into the font. Copying starts at the 
current character and proceeds left to right across the window, from 
top to bottom, until all the pixels have been used. 
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Fonts can be saved to and loaded from both cassette and disk by 
pulling down the 'File' menu and selecting the required operation. 
The tape operations behave in exactly the same way as in the main 
cassette menu, and the disk save and load behave in a similar 
manner to the tape operations. When cataloguing a disk, any fonts 
saved also appear in the list on the screen, and have the word "font" 
on the right to distinguish them from picture files. (These have the 
word "pic" on the right). Note that selecting a filename from the 
main files menu will have no effect on saving or loading a font on 
the disk. A font saved to tape or disk contains 728 bytes (91 x 8). 


When editing is complete, a return to the main menu can be made 


by moving the cursor to the box marked 'Menu' and pressing select. 
The font created or loaded is then available via the 'Text’ menu. 
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Note that this font editor doesn't have to be used exclusively for 
ordinary letters and numbers. It could just as well be used for the 
creation and editing of user defined graphics, or any other symbols 
that fit into 8 bytes. 


SHAPES 
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This menu is used to draw various shapes on the screen. Seven 
different shapes are available, namely single points, lines, a contin- 
uous line, rectangles, triangles, circles, and rays. Each shape is 
composed of line segments of single pixel width. Shapes are drawn 
by moving the cursor about the screen and pressing select to define 
the vertices. All shapes are drawn in the current Ink and Paper 
colours; Inverse and Over also apply. 


For example, to draw a triangle, pull down the Shapes menu, then 
click the 'Triangles' option. Move the cursor about the screen, and 
press the select button three times to define the three corners of the 
triangle. 


A circle may be drawn in two ways - by selecting the 'Circles 1' 
option, the centre is defined by moving the cursor and pressing 
select and a point on the circumference is then defined by pressing 
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select again. The 'Circles 2' option allows you to define the circum- 
ference point first, followed by the centre. 


Shapes can be drawn ‘elastically’. An elastic shape moves with the 
cursor across the screen, expanding and contracting as necessary. 
Pressing select fixes the vertex of an elastic shape as before. This is 
helpful in getting a shape into the correct position before being 
committed to that position. To draw an elastic shape, set the 'Elastic’ 
switch in the menu to ‘on’ before selecting one of the shape options. 


The vertices of shapes can be 'snapped' to each attributes square. 
This is useful for aligning components of a drawing. Snap 1s availa- 
ble independently in the horizontal and vertical directions. For 
example, setting both snap switches to ‘on’ would result in the 
corners of any rectangles drawn being at the bottom left corners of 
attributes squares. 
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APPENDIX 1 - CONFIGURING THE ART STUDIO CAS- 
SETTE 


The tape supplied is a master tape whose function is to produce a 
personalised copy of ART STUDIO, in the sense that it is config- 
ured for the machine you are using. This is necessary to avoid 
having to enter a number of details every time you wish to use the 
program - a configuration process 1s supplied which you need use 
only once to produce a working ART STUDIO program tape. Note 
that the tape supplied may not be used directly to run ART STUDIO 
(side 1 contains the Art Studio master, and side 2 contains some 
sample pictures). 


To perform the configuration process, you will need a blank cassette 
tape and the program master tape. Insert the master into your tape 
deck, make sure it is rewound, and press SHIFT and RUN/STOP to 
load and run the configuration program. 


The program will then ask you questions about your printer in order 
to perform the configuration process. The first question asks wheth- 
er your printer 1s connected via the Commodore's serial bus (for 
Commodore printers and certain interfaces) or by the built-in Cen- 
tronics interface. (Epson and other Centronics printers). If your 
printer uses the serial bus, the program asks you which device 
number the printer will respond to - for example, the MPS 801 may 
be device 4 or 5 depending on the position of the switch on tts rear 
panel - consult your printer manual for details. 


The program will then ask how many wires on the print head are 
used in bit image mode, if the number of rows of dots are printed on 
each pass of the head. The most common answer to this is 8, 
however, the MPS 801 and certain others use 7 wires only. Note that 
the number of wires used in bit image is not always the same as the 
number of wires in the print head - again, you should check your 
manual for details. The program also needs to know whether the top 
wire is controlled by the most significant bit of the data bytes sent 
to it or the least significant - for most printers, it is the most signifi- 
cant. 


The program then asks whether the unused bit of the data bytes sent 
to the printer should be set or reset - this question is only asked if 
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you are using 7 wires in the print head, and determines the state of 
the remaining bit in the data. For the MPS 801, the eighth bit should 
be set to identify the byte as bit image data, but for most others it 
should be reset. 


The next information requested by the program concerns the way in 
which the printer is set up at the start of a screen dump. ART 
STUDIO sets the printer up by sending eight bytes of data to the 
printer, and you must tell the configuration program which bytes to 
send. The MPS 801 does not require any set up, however most 
others will need to be told what line spacing to use. For example, an 
Epson MX-80, with 8 dots, or 8/72" and hence the codes for setting 
up the printer will be 27, 65, 8. Consult your printer manual for 
details of other codes that may be specified at the start of a dump. 


Special control codes are needed by printers to switch from their 
normal text mode to graphics mode. In addition, most dot matrix 
printers can operate in two different graphics modes, known as 
single density and double density. The resolution in the latter mode 
is generally greater than that in the former, 1.e. more dots can be 
printed across the page. Different control codes are needed for the 
two modes. ART STUDIO will ask how many dots your printer 
expects in single density, and the control codes to select that mode, 
and then it will ask for the same information for double density 
mode. If your printer has only one graphics mode, then enter 0 for 
the dots in double density. Again you can enter up to 8 control 
codes, separated by commas. Note that you can enter double byte 
parameters directly. For example, the responses for an Epson MX- 
80 printer would be 480 dots in single density, and control codes to 
select single density mode 27,75,480. 


When the dump is completed, a further string of bytes is sent to the 
printer - you can use this string to scroll the paper up 1f you wish, or 
to reset the printer line spacing or other functions. If you do not wish 
to use this feature, simply hit RETURN. 


Finally, the program asks you to enter the codes for a line feed and 
for a carriage return. Your printer may not require the line feed, 
since many printers will generate this code automatically when they 
receive a carriage return - on other printers there is a switch which 
determines whether the line feed is inserted or not. If your printer 
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does not require the line, enter the null code for the line feed 
character (normally 0). The normal values are 13 for carriage return 
and 10 for line feed. 


The program will then ask you whether you are happy with the 
parameters you have entered, displaying them on the screen to aid 
confirmation. If you are satisfied with these, enter "Y' and the 
configuration will continue, if you are not, entering anything other 
than "Y' will cause the questions to be repeated. 


The program will then load the remaining sections of code from the 
master tape and produce the working version of the program in the 
machines memory. Once this has been done (it will take a few 
minutes to load), a message appears requesting you to remove the 
master tape and insert the blank tape on which you wish to record 
your personal copy. Do this, and when you have made sure that the 
tape is fully rewound and ready, enter "Y'. The program will then 
produce your working version, which you use in future by using the 
SHIFT and RUN/STOP keys together, or by typing 


LOAD "" <RETURN> 
IMPORTANT NOTICE 


Oxford Computer Publishing Limited licenses you to make copies 
of ART STUDIO FOR YOUR PERSONAL USE ONLY, subject to 
the following conditions; (1) that you destroy or erase the copies 
before parting with the original, (2) that you neither supply nor lend 
copies to another person. Legal action will be taken against anyone 
failing to observe the conditions. 
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APPENDIX 2 - CONFIGURING THE ART STUDIO DISK 


When you run ART STUDIO from a disk, the program will search 
the volume for a file containing a description of, and routines for 
handling, the printer that you are using. When ART STUDIO is 
supplied, a file 1s included on the disk that supports the MPS 801 
printer, and if this 1s the one you are using then there is no need to 
perform any program configuration at all. 


However, if your printer is of a different type, or you wish to change 
the configuration at a later stage, 1t will be necessary to use the 
printer configuration program also supplied on the disk. This pro- 
gram produces the file which is loaded when ART STUDIO 1s run 
from disk, and is used separately from the main program by issuing 
the two BASIC commands: 


LOAD "STUDIOCONFIG",8 <RETURN> 
RUN <RETURN> 


The configuration program will now display all the parameters on 
the screen, and ask you if they are correct. If you enter anything 
other than "Y' then you will be asked to re-enter the parameters; if 
you are happy with what you have done, enter "Y' and the configu- 
ration program will write these parameters to the disk. The next time 
you load ART STUDIO, these new parameters will be used by your 
printer when dumping the screen. 


To run the disk version of Art Studio, type: 
LOAD "*",8,1 <RETURN> 
IMPORTANT NOTICE 


Oxford Computer Publishing Limited licenses you to make copies 
of ART STUDIO FOR YOUR PERSONAL USE ONLY, subject to 
the following conditions; (1) that you destroy or erase copies before 
parting with the original, (2) that you neither supply nor lend copies 
to another person. Legal action will be taken against anyone failing 
to observe these conditions. 
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APPENDIX 3 - WORKED EXAMPLE 


Finally we present a worked example showing the stages of con- 
struction of a picture and demonstrating some of the effects that can 
be acheived using the facilities of ART STUDIO. 
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We start with some outline lettering drawn by using the ‘lines’ 
option in the 'Shapes' menu. 
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The Magnify facility can be used to 'touch-up' the letters. Here we 
are using a x4 magnification. The cursor is used to alter the individ- 
ual pixels that comprise the letters. 
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The letters can now be filled in using the paint roller icon. 
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A window has been put around the completed text and a copy of it 
made by clicking the 'Cut & Paste’ option in the Windows menu. 
Immediately after this the 'Wash texture’ menu has been pulled 
down, and one of the stipple patterns selected. 
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The effect of this operation is that the chosen texture 1s washed onto 
the top set of letters. 
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Again a window has been defined around the lettering, and the 'Cut 
& Paste’ option selected from the Windows menu (this time with the 
'Merge" switch set to on). The second window outline is carefully 
positioned over the stippled lettering so as to slightly offset it and 
the select button pressed. The solid lettering is merged with its 
shadow. 
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The 'Cut & paste' option has been used to duplicate the lettering, and 
the 'Wash texture' facility has been employed for a second time to 
add a pattern to the top set of lettering, but this time a denser stipple 
has been used. This gives a pleasing three-dimensional appearance 
to the letters. 
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The lettering at the bottom has been deleted, and further detail has 
been added to the picture with an elastic line from the Shapes menu. 
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Here the x8 magnification grid is being utilised to design a mouse 


character. 


At this point we can try using the paint roller option to add some 


texture to the picture. 
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If we decide we don't like this last move, we can simply click the 
'Undo' box to remove it, and try something else. Like designing a 
new texture and then filling the screen with it. 


print|File |Attrs|Paint Undo 5 
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Although many of the features of ART STUDIO are not covered in 
this short worked example, we hope it gives you some idea of the 
potential of the program. 
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APPENDIX 4 - BASIC SCREEN LOADER 
The ART STUDIO disk, and the first file on the b-side of the 
cassette contain a BASIC program to enable you to load pictures 
created on the ART STUDIO onto the screen, so that they can be 
easily displayed, or used as loading screens for your own programs. 
The cassette version is loaded using the commands 

LOAD "SCREENLOADER" <RETURN> 

RUN <RETURN> 
The disk version is loaded using 

LOAD "SCREENLOADER" ,8. <RETURN> 

RUN <RETURN> 


By listing the program you will be able to modify it so that it loads 
your own programs after displaying the picture. 
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define, window 
disks 

dot matrix printer 
double density 


E 
edit, brush 
edit, texture 


3.4,19,26 
6,12,28,33 


10,11 


18 
1,8,9, 


6,7 
7,35 


10,11,31,37,44 


16 
23,24 


45 


elastic 33 

erasers 14 

F 

files 8.31,37,44 
fill, solid 2122 

fill, textured 22 

flip, character(s) 30 

flip, window 18,20 

font 29 

G 

erey-scale 7 

erid 26 

H 

hard copy 6 
highlight 3 

home box 26 

I 

icons 3 

ink 6,12,13,14,17,19,26,27,32 
inverse 13,14,22,24.26,27,32 
invert, character(s) 30 

invert, window 20 

J 

joystick 2S 

justify 7 

K 

keyboard 2 

koala pad 2 

L 

last window 19 

lines 32 

load, file 9,10,31,34,37,44 
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M 


magnifying glass a 
mask 16 
menu bar 2,26 
merge, file 9,10 
merge, window 19,20 
mouse 2D 
multiple 19,20 
N 

null brush 16 
null texture 22 

O 

over, overwrite 9,19,22.26,27,32 
P 

paint roller 21 
pan 24 
Paper 6,13,17,19,22,24.27,32 
patterns 21 
pens 14 
pixel 6,24 
points 52 
printers 34,37 
pull-down menus 3 

R 

rays ao 
rectangles 32 
re-scale window 20 
rotate, character(s) 30 
rotate, window 2 | 

S 

save, file 8.10 
scroll, catalogue 10 
scroll, character(s) 29 
scroll, font 30 
scroll, magnify 26 
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scroll, screen 
select button 
sideways 
single density 
snap 

Spray cans 
switches 


T 

textures 
transparent 
triangles 


U 
undo 
user defined graphics 


Vv 

verify, file 
version number 
view screen 


W 
wash texture 
windows 


Z 
zoom 


3,4,19,22 


17.18.2297 
=) 


9 
17 
17 


23 
17,18,19,20,21,31 


24 
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